home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / StartupTools / MKick19.lha / MakeKick.doc < prev    next >
Text File  |  1995-01-01  |  4KB  |  107 lines
  1.  
  2.                                  MakeKick 1.0
  3.  
  4.                        (c) 1993 MJSoft System Software
  5.  
  6.                                  Martin Mares
  7.  
  8. ==============================================================================
  9.  
  10.  
  11. Introduction
  12. ------------
  13.  
  14.    This utility has been writen for easy creation of kickstart header files
  15. (*.kick).  It's able to convert the old-style files (*.RTB, *.PAT) to the
  16. kickstart header source (*.kshd) and to compile the source.
  17.  
  18.    See README for copyright and other information.
  19.  
  20.  
  21. Parameters
  22. ----------
  23.  
  24.    MakeKick can be started only from CLI with following parameters:
  25.  
  26. KSNAME - kickstart base name (for example kick39106.A1200).
  27.  
  28. AUTO/S - generate the source file automatically from RTB, PAT and the
  29. kickstart image file.
  30.  
  31. KICKTO/K - store processed kickstart to specified file in ROM Image format.
  32. Used mostly for conversion of files extracted from SuperKickstart disks or
  33. for decoding of encrypted kickstart files (new beta-releases for A600).
  34.  
  35.  
  36. Notes
  37. -----
  38.  
  39.    MakeKick currently supports ROM Image, KickIt, SuperKickstart and Encrypted
  40.    file formats.
  41.  
  42.    The BCPL-relocations are NOT converted from the old-style files.
  43.  
  44.    The relocation table is taken from the RTB file in both modes of operation.
  45. (it isn't included in the KSHD source file).
  46.  
  47.    MakeKick creates automatically following patches (in AUTO mode only):
  48.  
  49.         - The C0-RAM end patch (see the C0END command)
  50.         - The NO-C0-RAM patch (see the C0PATCH command)
  51.         - The CHIP-RAM-STACK patch (needed to use kick V39+ on systems
  52.           with only 1MB of CHIP RAM)
  53.  
  54.  
  55. Kickstart header source file
  56. ----------------------------
  57.  
  58.    It's a plain ASCII file containing commands on separate lines. You can
  59. write one long command (useful especially for long patches) on more lines
  60. using the '\' character on the end of each line excluding the last one.
  61. Comments are prefixed with ';'.
  62.  
  63.    Commands:
  64.  
  65. ADDRESS <hex-address> - base address of the kickstart. All following addresses
  66. will be relative to this base address.
  67.  
  68. LENGTH <hex-length> - kickstart image length in bytes
  69.  
  70. VERSION <dec>.<dec> - kickstart version
  71.  
  72. DISKPOS <hex-position> - use direct (track-) loading from the Kickstart Disk
  73. starting at given relative offset (in bytes from start of the disk - see
  74. doc of trackdisk.device).
  75.  
  76. PATCH <hex-address> <hex-list> - use given patch. The list of values is a list
  77. of hexadecimal 8-bit numbers. The numbers can be separated by spaces or tabs.
  78.  
  79. RELPATCH <hex-address> <hex-rel-long> - use given relative patch. The base
  80. address of the kickstart (in RAM) will be added to <hex-rel-long> during the
  81. patching process.
  82.  
  83. C0PATCH <hex-address> <hex-list> - patch used when the kickstart is being
  84. loaded on address C00000.
  85.  
  86. BREL <hex-long-list> - a list of BCPL-relocations. Used only when kicking KS
  87. 1.3 or lower. (MKick isn't able to kick 1.3, but it supports this type
  88. of relocations.)
  89.  
  90. C0END <hex-address> - address of the $00DC0000 longword in C0-memory test
  91. routine. It will be patched when kicking to C0-RAM. More addresses can be
  92. specified and are separated by spaces.
  93.  
  94. CHECKSUM <hex-long> - original kickstart checksum. This checksum will be
  95. checked during the kicking process to find out if the kickstart image is the
  96. corresponding one for this header file.
  97.  
  98. AUTOSUM - use automatical checksum on each reset. Used mostly for kickstarts
  99. without their own auto-checksum mechanism (34.005 and 39.110.A500).
  100.  
  101. PATCH1 ... - same as PATCH, but used only when kicking with KS 1.x in ROM.
  102. Used only by MKick (or maybe other 1.X-based kickers).
  103.  
  104. PATCH2 ... - same as PATCH, but used only when kicking with KS 2.0 or higher
  105. in ROM. Will be used by 2.0-based kickers if some of them will support this
  106. format.
  107.